home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / program / multlang.zip / README.TXT < prev    next >
Text File  |  1996-06-12  |  25KB  |  472 lines
  1. TMULTLANG PACKAGE FOR DELPHI v1.152
  2. (C) 1995 Patrik Wang
  3.                                  12 June 1996
  4.  
  5. INDEX
  6.  1  Description
  7.     1.1  Features
  8.  2  Installation (Problems)
  9.     2.1  Files
  10.     2.2  Dependencis
  11.     2.3  Un-Installing
  12.  3  Shareware
  13.  4  Disclaimer
  14.  5  Register
  15.     5.1  Ordering
  16.  6  History
  17.  7  Author / Support
  18.  
  19.  
  20. 1   DESCRIPTION
  21. Forget Windows resource files (.RES, .RC ...) this component will make you
  22. internationalized without writing any additional code. Just drop it on your
  23. form and re-compile, finished. This component will translate properties in
  24. Delphi, at both design and runtime. Targeting bi-lingual and multi language 
  25. support, but it can be used for many other things. Support for switching 
  26. language at run-time independant of the running Windows version. 
  27. This component will alter almost all properties that the object inspector can 
  28. edit. You can choose if you want your languages to be saved in the form or a 
  29. file. You can use the same file for all your form languages within the same 
  30. application. It works in a multiuser environment and it is aware of other 
  31. forms. You can share languages between different forms and manipulate those 
  32. even at runtime.
  33. Come on and jump on the train to Rapid Application Development, it's lightening
  34. fast. Why use expensive tools to maintain different languages in C++ or other
  35. tools when you have this TMultLang package in Delphi.
  36.  
  37. The MultLang package includes 12 components, the MExtras package described
  38. below and also the TComponentCollector(Full source) component. With this
  39. package you will be able to to make professional bi lingual applications.
  40.  
  41. The MExtras package have 9 components that supports translation of all 16- and
  42. 32-bit common dialogs and one component for translating Message Boxes and
  43. Buttons. More information can be found in the MEXTRAS.TXT file.
  44.  
  45. The ComponentCollector component hides all your Non-Visual components so they
  46. wont clutter your form. It is very useful when you use databases with many
  47. queries on the form. More information is provided in the COMPCOLL.TXT file.
  48.  
  49. All components in our packages are pure Delphi components available in 16- and
  50. 32-bit. They are also cross-platform compatible 16<->32 bit and form file 
  51. (*.dfm) compatible. You can safely depend on our components for Delphi in any
  52. environment, full source is also available to the public for all components.
  53.  
  54. 1.1x FEATURES
  55. * Specialized for multi language support in Delphi.
  56. * Double byte languages support
  57. * Switching language at run-time independant of the running Windows version
  58. * Supports translation of Win 3.1 objects even when developing on Win 95
  59. * Get multi lingual by just drop this VCL on a form (No additional coding)
  60. * Available as 16 and 32 bit with the fully source code in pure Delphi Pascal
  61. * Change text of almost all Component and Control properties
  62. * Support for translation of TStrings items and TFont objects
  63. * Multi-user shared resource file(s) (when an external file is used)
  64. * 16- and 32-bit Common dialogs support (without any DLL or RES files)
  65. * Delphi standard Message dialogs support (ShowMessage, MessageDlg, Input ...)
  66. * Write you own run-time property editor via INI files
  67. * Date, Time, Currency and Number format translations
  68. * Switch languages from selectable controls (Menus, DropDown, RadioGroup etc)
  69. * Save language translation in forms (design time) or external files
  70. * Even translates it self (Localized language names)
  71. * Aware of other forms within the same application
  72. * Objects and Properties browsable, just point and click
  73. * Share languages/properties/values between several forms
  74. * One run- and design-time editable resource file for one or more forms
  75. * Extensive help integrated with Delphi
  76. * Safe syncronisation when changing names, removing or inserting components
  77. * Associate icons (stretchable) to each configuration.
  78. * An easy property editor which is integrated in the Delphi environment.
  79. * Filter to restrict language translations (usable in a multi user environm.)
  80. * Supports translation of any language in Win 3.1, 95 and NT
  81. * Right-To-Left script translations
  82. * Add on's available for many different languages
  83. * 32-bit huge strings, >255 bytes (32-bit version)
  84. ***** MANY MORE FEATURES INCLUDED, PLEASE CHECK IT OUT YOURSELF ******
  85.  
  86.  
  87. 2   INSTALLATION
  88. If you already have installed a previous version you will have to uninstall
  89. that one first. Please advice the old readme.txt file in the previous version.
  90. This installation installs both the TComponentCollector and the MExtras
  91. package, so if you already have one of them installed, please remove that
  92. component in the 'Install Components dialog' prior to this installation.
  93.  
  94. STEP 1. First unpack MULTLANG.ZIP or MULTLAN2.ZIP in an own directory (you
  95. have probably already done that by reading this), this archive have
  96. subdirectories included.
  97.  
  98. STEP 2. Move all *.HLP files to any directory in your search path, preferable
  99. the DELPHI\BIN directory where other Delphi helpfiles resides.
  100.  
  101. STEP 3. Then install the MULTREG.PAS or MULTREG2.PAS file via the 'Install 
  102. Component' menu option in Delphi. If any problems occurs, you can get your 
  103. old library back from the backup file *.BAK that Delphi automatically makes
  104. (for more instructions see page 69 in the Users Guide). Please note that the 
  105. Component path in this dialog is restricted to 255 characters (Delphi 1.0), 
  106. this component must be in that path or the global Windows path.
  107.  
  108. STEP 4. Install the MULTLANG.KWF and MEXTRAS.KWF files with the Helpfile
  109. installer program (HELPINST.EXE) supplied by Delphi. This enables you to press
  110. F1 in the Object Inspector to invoke help on that property. (Not necessary if
  111. you just want to have a quick look at the component).
  112.  
  113. PROBLEMS  !!!!! NOTE !!!!!!
  114.  
  115. We recommend to increase the stack size from the standard 16384 bytes to at
  116. least 32768 in your large projects.
  117. If you plan to support editing of languages at run-time (Calling with the
  118. MultLang1.Edit(nil);) you must increase the stack size!
  119. However, we have concentrated on making the component as little memory
  120. consuming as possible, but we cannot change the Delphi Pascal object structures
  121. with the standard units that declares lot of global variables. The stacksize
  122. can be changed in the 'Options-Project' menu under the tab 'Linker' and also
  123. by using compiler directive {$M 32786 8192} in your source. It is not possible
  124. to adjust stack sizes in components, that's why we have to ask you to do it
  125.  
  126. If you encounter "Outline Index Not Found" or "Invalid Index" while working in
  127. the Language Editor, please update your Delphi version. Apply latest free 
  128. patches from Borland, the OUTLINE.DCU unit has several bugs that will be
  129. corrected when patched. This problem occurs if you are running the very first
  130. version of Delphi.
  131.  
  132. If you have added several languages but they are not visible in the drop down
  133. list of the TMultLang component, please make the ItemHeight < Height and will
  134. show up in the list as it should.
  135.  
  136. That's it !!!!
  137.  
  138. Look at the Multi Lingual component palette in Delphi. Why not start with the
  139. Step-By-Step right away, the quick one takes only 5 min. Check the helpfile for
  140. more details by a right click on the TMultLang component at design time.
  141.  
  142. For implementation details please advice the included technical papers named
  143. TECH*.TXT. They descibe important implementation methods and is highly
  144. recommended to read. 
  145.  
  146. Also please look at the sample project in the example subdirectory for advice
  147. and to look at source examples.
  148.  
  149.  
  150. 2.1 FILES
  151. These files is included in the TMultLang package.
  152. ADDPROP.DCU   Compiled unit of the Add properties dialog.
  153. ADDPROP.DFM   Add properties dialog.
  154. COMPCOLL.DCR  Design time bitmaps for the TComponentCollecter
  155. COMPCOLL.DCU  TComponentCollector component
  156. COMPCOLL.TXT  Text file for the TComponentCollector
  157. COPYFROM.DCU  Compiled unit of the Copy From dialog.
  158. COPYFROM.DFM  Copy From dialog.
  159. LANGEDIT.DCU  Compiled unit of the Language Property Editor dialog.
  160. LANGEDIT.DFM  Language Property Editor dialog.
  161. MBUTTONS.DCU  Multi language support component for Delphi sta